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Within this manual and associated software, the BBC refer to the British 
Broadcasting Corporation. The term ‘BBC Micro’ refers to the computer manu¬ 
factured by Acorn Computer PLC under licence from the BBC. ‘Tube’ and ‘Econet’ 
are registered trademarks of Acorn Computer PLC. 

All rights reserved. No part of this Manual (except brief passages quoted for critical 
purposes) or of the computer programs to which it relates, may be reproduced or 
translated in any form or by any means, electronics, mechanical or otherwise, 
without the prior consent of the copyright owner. 

Disclaimer: Because neither the BBC nor Morley Electronics have any control over 
the circumstances of use of the programs, no warranty is given or should be implied 
as to the suitability of the programs described in this manual for any particular 
application. No liability can be accepted for any consequential loss or damage 
however caused, arising as a result of the operation of the program. 
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IF YOU ARE RECEIVING TELETEXT ON AN ORDINARY TELEVISION 
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Introduction 


This User Guide contains all the information you need to use the Teletext 
Adapter. 


Chapter 1 
Chapter 2 
Chapter 3 
Chapter 4 

Chapter 5 
Chapter 6 


explains how to connect up the Teletext Adapter and tune it in. 
describes the facilities available with the Teletext Terminal, 
describes how to download Telesoftware, 
describes the extra Operating System commands that the Teletext 
ROM provides. 

gives details of the OSWORD call used by the Teletext software, 
gives detailed technical-information on the data formats and the 
Teletext character set. 


Appendix A 
Appendix B 
Appendix C 
Appendix D 
Appendix E 
Appendix F 
Appendix G 
Appendix H 


explains just what Teletext is. 

gives hints and advice on Teletext reception. 

is a table of Network Identity Codes for the United Kingdom. 

explains about using PANOS, CP/M and DOS+ Telesoftware. 

is a statement about copyright of BBC Telesoftware. 

explains how to insert the Teletext ROM. 

is a summary of the Operating System commands. 

is a summary of the Terminal keys. 
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1 Getting Started 


1.1 The Components 

You should have: 

One Teletext ROM 
A function key strip 
This manual 

A Morley Teletext Adapter 

You will not need a new aerial lead as the existing television aerial lead can be 
used. 

The Teletext ROM will operate with any BBC model B, B+, or Master 
Microcomputer which uses Operating System version 1.2 or higher. If you are 
not sure which operating system your computer uses, switch it on, then type 
*FX0 and press RETURN. 

You will see the letters OS plus a number. If this number is 1.20 or higher, you 
can go straight on to the next section. If you see: 

OS0.10 or OS1.00 

your operating system is unsuitable and to use Teletext you must fit a newer 
operating system ROM to your machine (your Acorn dealer will advise you on 
this). 


1.2 Connecting up the Units 

The first thing to do is to ensure that the Teletext ROM is installed correctly 
(see Appendix F). 

Next, refer to Figure 1 which shows the microcomputer and Teletext Adapter and 
connect up the system as follows: 

1 Connect the 20 way plug on the Teletext Adapter ‘ribbon’ cable to the socket 
labelled ‘Users Port’ on the underside of the computer. 

Caution: This plug may fit both ways round - the correct way is with the arrow at one 
end of the plug aligned with the arrow next to the User Port label. IF THE PLUG 
WILL NOT FIT, EXAMINE THE SOCKET FOR DAMAGE AND 
OBSTRUCTIONS. DO NOT USE EXCESSIVE FORCE. 
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2 Connect the 6 way power supply plug to the computers power supply, or our 
optional PSU. 

3 Disconnect the aerial lead from the back of your television set and reconnect it to 
the standard television aerial socket on the back of the Teletext Adapter. 

Note: Indoor aerials don’t generally provide a strong enough signal. You will in all 
probability need a loft or externally mounted aerial. If you don’t think your aerial is 
good enough refer to Appendix B, or consult your TV dealer. 

4 Place the key strip under the clear plastic trim at the top of the computer keyboard. 

5 Switch on the Teletext Adapter then switch on the monitor, microcomputer and 
storage device (e.g. disc drive or cassette machine) if fitted. IT IS IMPORTANT 
THAT THE TELETEXT ADAPTER IS SWITCHED ON BEFORE THE 
MICROCOMPUTER, otherwise you will have to press BREAK on your computer 
after switching on the Adapter. 

To check that all is well, type *HELP and then press RETURN. 

A message similar to the following should be displayed: 

Teletext 2.50 (BBC1) 

The help text for any other ROMs you have in your computer may also be displayed. 

If the message ‘No TTX Unit’ appears, it means that the Teletext ROM cannot 
find’ the Teletext Adapter, so check that the Adapter is connected properly. 


Underneath the BBC Computer 
User 1 MHz Bus TUbe 

■ni tMtMtiM im am •••••••••••••••»• tm mi 

m— ——iub m——im wjj f«■ 


1 eletext Adapter 


TV Aerial 




6 Way Plug 


jjjHpEg] 


20 Way Plug 
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Figure 1 Connecting the Teletext Adapter 


















Getting Started 


1.3 Tuning the Teletext Adapter 

The Teletext Adapter can be tuned to four seperate channels, assigned numbers one 
to four. We recommend that you allocate these channels as: 

Channel 1 - BBC1 -A + 1 ^ Cj 3 3 

Channel 2 - BBC2 A6 0| Cl* 

v Channel 3 - ITV A ^ % 

Channel 4 - Ch4 or S4C ftCjs % 

If you tune the channels in a different order, the channel selection commands 
such as *BBC1 may not work properly. 

The procedure for tuning in the system to receive each channel is as follows : 

1 Type in ‘TELETEXT on the computer then press the RETURN key. The 
message ‘BBC1 ’ will appear in the top left of the screen. 

2 Press the SHIFT key together with the red function key fl (BBC1) to select 
channel 1. 

3 Press the SHIFT and f® (Tune) keys together. Your screen will display a blank 
page except for the bottom line which will show &2700 Ch 19 and indicates the left 
and right cursor keys are to be used to tune the unit. 

4 Tune up slowly, with the right cursor key only, until a ‘HEADER’ line appears. 
(Note it is very easy to tune past the best frequency, so at this stage tune back down 
with the left cursor key a little). Then repeatedly dab the right cursor key until the 
Header is uncorrupted with the clock in the top right corner imcrementing at one 
second intervals: By this time the index page for the current channel will have 
appeared. 

We recommend that you tune up until errors start to appear in the page header, 
making a note of the frequency in the bottom left corner of the screen and then repeat 
this, tuning down past the channel. You should find that the best results are obtained 
at a frequency midway between the two. REMEMBER, YOU CAN RECEIVE 
ALL FOUR TELETEXT CHANNELS ON EACH TUNING CONTROL, SO 
MAKE SURE YOU GET THE RIGHT CHANNEL. 

5 Press the SPACE-BAR on your keyboard and repeat steps 2 to 4 for channels 2,3, 
and 4. The only differences are: 

In step 2, you should press the appropriate channel selection button, with SHIFT. 
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6 When you have tuned in all four channels, press SPACE-BAR. This will remove 
the tuning scale and a Teletext index page will be automatically displayed. This is the 
index page for the channel you tuned last. 

7 You will now have to save your ‘Channel data’. To do this simply type ★STUNE 
filename. This will then save the current channel Frequencies to Disc or Tape. 

If you have more than Four channels in your area, you can save and reload as many 
different sets of channel data as you require. 

8 You will have to load this channel data whenever you want to use the adapter. To 
do this simply insert the Disc or Tape containing your channel File and Type 
★LTUNE filename. The Frequencies are then loaded and will stay resident until the 
computer is turned off. 


2 The Teletext Terminal 


The Teletext Terminal behaves in the same way as the Teletext section of a 
television. However, it also has some extra facilities. Instead of using a remote 
keypad you use the BBC Microcomputer's keyboard and function keys. The 
function key strip should be placed above the red function keys when using the 
Terminal. 

2.1 Enter the Terminal 

To select the Teletext Terminal, type *TELETEXT and press RETURN. BBC1 
CEEFAX is selected by default and the initial page is displayed once it has been 
received. This initial page is usually an index to the service. 

At the top of the screen you will see a line of text which is constantly changing. 
This consists of: 

The channel title, or page number selected 
The name of the Teletext service (e.g. CEEFAX) 

The page number indicator, which displays the page number of the page 
presently being transmitted 
The date and time 


2.2 Leave the Terminal 

To leave the Terminal, press f9. 

If you are using a co-processor (e.g. 6502 second processor, etc.), this will 
return you to the language or application that you called Teletext from. 
Normally, any programs, or data, will remain intact. If you are not using a 
co-processor, pressing f9 will start B ASIC; any programs, or data, will be lost. 

The BREAK key 

In order to work properly with different co-processors, the Terminal does not 
start up as a language if you are using a co-processor. This means that if you 
press BREAK, you will leave the Terminal and you will return to the previous 
language, or application. On systems without co-processors, pressing BREAK 
will re-initialise the Terminal, and clear any ‘kept’ pages (see Section 2.11). 
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2.3 Select a Page 

To select a page, simply enter the page number using the number keys. The 
number you enter will appear at the top left of the screen, preceded by the letter 
‘P’ for PAGE. If you make a typing error, or simply want to replace the last 
digit entered, press DELETE. 

When all three page number digits have been entered, the Terminal will start 
looking for the page. The middle section of the top line will turn green to 
indicate that a page is being searched for. When the page is found, the Terminal 
displays it immediately and the top line of the screen turns white, signalling that 
the page has been found. The page number may also change colour. Red 
indicates that the page is corrupted or incomplete, and yellow means that the 
Terminal is unable to determine whether the page is alright or not. 

Note that you can instruct the Terminal to look for a new page while it is still 
searching for the one you initially specified. It will automatically start looking 
for the new page when you enter the last digit. 

At the bottom of the screen there may be a series of coloured boxes, followed 
by page numbers, or alternatively, a series of coloured ‘keywords’. These 
correspond to the four coloured blocks on the key strip (fl to 14). They show 
that the current page has ‘links’ to other pages. These links tell the Terminal 
that the pages specified are likely to be selected next, so it should capture them 
if they come by. This means that if you select one of these pages, either by 
entering its page number, or by pressing one of the coloured buttons, it will be 
displayed more quickly. If the bottom line contains coloured keywords, this 
means that the Teletext Editors controlling the broadcast have told the 
Terminal what sort of page the links point to. 

Next to the four coloured keys you will find the INDEX button (10). Normally, 
pressing this will take you back to the index page. This may be the main index 
page, or a sub-index, such as the sport index. 


2.4 Change Channel 

To change channel at any time, press one of the four function keys fl to f4, 
while holding down the SHIFT key. This will clear any kept pages and the 
Terminal will start to look for the initial page of the channel chosen. 
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2.5 Tune a Channel 

Pressing SHIFT and fe will display the Index Page. See ‘Tuning the Teletext 
Adapter’ (Section 1.3) for more details on tuning channels. 

When you have finished tuning, press the SPACE-BAR to leave the tuning 
routine. 

Note: Any new frequencies will have to be resaved with *STUNE. 


2.6 Reveal and Conceal 

Certain Teletext pages contain ‘concealed’ information. These include quizzes, 
jokes, etc. They usually contain a phrase such as : 

Press REVEAL for the answers 

To display the concealed information you should press f6. This will ‘reveal’ the 
information and put the page on ‘hold’ (see the following section). Press f6 to 
conceal the information again and release the page. 


2.7 Hold and Release a Page 

Pressing the f7 key will hold the currently displayed page and stop it from 
being updated by subsequent rolling pages. The clock display in the top 
right-hand comer will be replaced by the word ‘HOLD’. 

To release the page, and allow it to be updated, press 17 again. The clock display 
should re-appear. The page is automatically released when a new page number 
is entered. 


2.8 Select a Sub-Page 

Some Teletext pages consist of more than one screenful of text. The individual 
pages are transmitted in sequence. A good example of this is Newsreel on 
BBC1. This consists of about a dozen ‘sub-pages’. Each of these sub-pages has a 
number from one upwards. If you wish to select a particular sub-page, you 
should press f8. The clock display in the top right-hand comer of the screen 
will be replaced by an ‘S’ followed by four dashes. Any numbers you ncrw type 
will replace the dashes in the same way as they do when entering a page 
number, except this time there are four digits to enter. DELETE works in the 


The Advanced Teletext System User Guide 


same way as for page numbers. Leading zeros are important and must be 
entered; sub-page twelve, for example, would be entered as 0012, sub-page 
three would be entered as 0003, etc. 

Once four digits have been entered, the Terminal will start searching for the 
sub-page specified. 

To return to entering page numbers rather than sub-page numbers, press f8 . 


2.9 Load a Page 

If you wish to display a Mode 7 screen stored on the current filing system (disc, 
network, etc.), press the SHIFT and f6 keys. The message ‘Load Page : ’ is 
displayed, followed by a flashing line. 

Type the filename of the screen you want to load, and press RETURN. 

The screen is then displayed, along with the message ‘P. ass SPACE to continue’. 

When you press the SPACE-BAR, the top line starts to change again and the 
page displayed before you pressed SHIFT f6 re-appears. 


2.10 Save a Page to File 

To save a page of Teletext to the currently selected filing system, such as disc or 
network, press the SHIFT and f7 keys. The message ‘Save Page : ’ is displayed, 
followed by a flashing line. 

Type in the filename for the page and press RETURN. (See the filing system's 
user guide for more information on filenames.) 

The page is then stored in a file. If an error occurs when saving the page, a 
message is displayed. 

When the page has been saved, the Terminal is ready for another command. 


2.11 Kept Pages 

If you are using Teletext for long periods at a time, you will find there are 
pages which you want to keep returning to, such as news and financial 
headlines, the sports results, or the weather. The Terminal has the ability to 
‘keep’ some of these pages for you, updating them when it can, so that when you 
select them, they appear immediately, without your having to wait for them to 
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come round. The number of pages that can be kept in this manner is determined 
by the memory available in the computer. It ranges from about 7 to 11 pages. 

To keep a page, select its page number in the usual way and press COPY. The 
message ‘Kept’ will appear at the bottom of the screen and the computer will 
beep. You can now go and select another page to be kept, without having to wait 
for the previous page to be displayed. If you fill up all the available space for 
kept pages, the message ‘Buffer Full’ will be displayed, and the page will not be 
kept. 

To release a kept page, select its page number and press COPY again. The 
message ‘Released’ will appear and the computer will beep. 

To release all the kept pages, press SHIFT and COPY together. The message 
‘All Released' will be displayed, and the computer will beep. 

To see what pages have been kept, use the ‘Terminal Status’ facility (Section 

2 . 12 ). 

2.12 Terminal Status 

To see what pages the Terminal is currently looking for, together with any kept 
pages, press the RETURN key on its own. The screen will display a page 
showing the page numbers. 

To return to the main Terminal mode, press the SPACE-BAR. 

2.13 Operating System Commands 

If you wish to perform an OS command, press the * on the keyboard and enter 
the command, followed by RETURN. The command will then be executed and 
the message ‘Press SPACE to continue’ will appear. If you wish to perform 
another OS command, press * again. 


2.14 Previous Page 

When you are looking at pages which have more than one sub-page, the page is 
often updated before you have had time to read it. To get round this problem, 
the Terminal has a ‘previous page’ facility. Pressing TAB switches between the 
current page and the previous page, giving you more time to read the pages. If 
another new page arrives, it is automatically displayed and TAB then switches 
between it and the previous page. 


The Advanced Teletext System User Guide 


2.15 Telesoftware 


If you wish to download a Telesoftware file, you should first select the correct 
channel and then press f5. This starts the Telesoftware Terminal. For more 
information on how to use the Telesoftware Terminal, see the next chapter. 


PI00 CEEFAX 187 Sun 20 Apr 








16 





































































































































































































































































































































































3 The Telesoftware Terminal 


3.1 Introduction 

‘Telesoftware’ is the name given to any software that is distributed by 
electronic means, e.g. Teletext and Viewdata. 

The Teletext Terminal has a built-in Telesoftware Terminal for downloading 
programs and data files onto your local filing system (e.g. disc or Econet). This 
makes the business of using Telesoftware very easy. 

Telesoftware files are divided into sections, called ‘blocks’. Each of these 
blocks occupies one sub-page of a Teletext page. Normally, a block contains 
about 800 bytes of information, encoded in a special format called ‘Redefinable 
Telescftware Format’ (RTF). This format is very complex and it is beyond the 
scope of this manual to describe it 


3.2 Ordered and Disordered Files 

There are two sorts of file in Telesoftware. One is the ‘ordered’ file and the 
other is a ‘disordered’ file. 

Ordered files have to be downloaded in strict order, starting from block 1 of 
the file and carrying on until the end of the file. If an error occurs, in the fourth 
block of the file, for example, the Telesoftware Terminal has to wait for the 
fourth block to come round again before it can continue downloading the file. 
This makes ordered files very time-consuming to download, if you do not have 
a perfect signal from you aerial. 

Disordered files can .be downloaded in any order. Say the Telesoftware 
Terminal is downloading a file; it downloads the fourth and fifth blocks, but an 
error occurs in the sixth block. Well, it will skip the sixth block and download 
the seventh. It will carry on downloading blocks until the loading cycle comes 
round to the fourth block again. It will then wait for the sixth block, without 
doing any downloading, and attempts to download the block again. This ability 
to load the blocks in any order makes disordered files far more convenient. 
Most files on CEEFAX are disordered. 
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3.3 Differences Related to Filing Systems 

The operation of the Telesoftware Terminal differs slightly if you are using the 
cassette filing system instead of disc or Econet. 

Normally, when using disc or Econet, each block of a file is saved as it is 
received. This allows the Terminal to download larger files than would 
otherwise fit in memory. 

Cassettes are not fast enough to save each block as it is received, so if you are 
using cassettes to store files, rather than discs or Econet, blocks have to be 
stored in memory until the whole file has been received. This means that 
cassette users cannot download some of the very large files available on 
Telesoftware. This is not as much of a problem as it may appear, because the 
chances are that programs that use very large files will not work on 
cassette-only machines anyway. 


3.4 Downloading a File 

On Teletext services that carry Telesoftware there is a special page called the 
‘catalogue’. This page contains a Telesoftware file which has details of all the 
programs currently available on the service. The actual position of this page is 
not defined, but the Telesoftware Terminal can find it by using a ‘link’ from the 
index page. 

To download a file, follow this procedure: 

1 Enter the Teletext Terminal. 

2 Press f5 (Telesoftware). 

The computer will now look for the catalogue of Telesoftware. If there is no 
catalogue, an error message will be displayed. It may take the computer several 
seconds to find the catalogue so please be patient. 

Once the catalogue has been found, the first few entries are displayed on the 
screen. Only those entries that say they are suitable for the BBC 
Microcomputer will be displayed. 

3 Scroll through the list using the UP and DOWN cursor keys to move the 
coloured bar. 

4 When you have found the program or file you want to download, press the 
RETURN key. 
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Some of the entries may be in colour. If the item above or below an entry is in 
the same colour, this indicates that the files go together and both should be 
downloaded. There may of course be more than two files in a group. 

When you have selected the file you want to download and pressed RETURN, 
the screen will clear and the name of the file, along with its load and execution 
addresses, will be displayed. 

The computer now waits for the page containing the file to arrive. 

When it finds the file, a display of all the blocks in the file appears - this is 
initially in white. As each page of a file is found, the appropriate block turns 
green, unless an error is detected, in which case the block turns red. If there are 
more than eighty blocks, a text message is displayed instead. 

When all the blocks are green, the complete file has been downloaded. If you 
are using a cassette system, the Terminal will now save the file, so place a 
cassette in the recorder and follow the standard SAVE instructions. 

Once the file has been saved, the Telesoftware Terminal will again look for the 
catalogue and display it. If you have finished downloading Telesoftware, press 
ESCAPE to return to the main Terminal. 

If you are downloading a group of related files, you should start by 
downloading the first file, and carry on downloading each file in turn until all 
of them have been downloaded. You should not exit the Telesoftware Terminal 
between downloading files. 

When you have downloaded the group of files, you should exit and re-enter the 
Telesoftware Terminal before downloading any other files. 

Hint for Disc Users: If you are going to download a large Telesoftware 
file, it is a good idea to COMPACT the disc before you start to make sure there 
is sufficient room on your disc. (See the Disc System User Guide for 
information on compacting discs.) 
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CEEFAX 705 Sun 23 Feb 18:30/41 

Filename : MANDEL 

Load : &FFFF1900 Exec : &FFFF8023 
24 out of 35 block(s) received. 

■ Not Received ■ Ok $ Error - Retry 

imiiHimmum 


This program will take about 12 minutes 
to download, so please be patient. 


Figure 5 The File Selection Screen 
CEEFAX 138 Sun 23 Feb 18:31/18 



Mandel 

ManNote 

Examl 

Exam2 

Exam3 


BBC BASIC 
Text 

BBC BASIC 
BBC BASIC 
M/C 


35 Pages 

4 Pages 
12 Pages 

5 Pages 
1 Page 


Notes Text 8 Pages 
MLive Text 6 Pages 
NIM Pascal 11 Pages 


See Page 702 for more details. 

Use the UP & DOWN cursor keys to select 
a file, and press RETURN to download.. 
Press ESCAPE to exit. 

Figure 6 The File Downloading Screen 
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4 Teletext Operating System Commands 


4.1 Introduction 

This chapter is only of interest if you intend to write your own programs to 
handle Teletext data. 

The Teletext Operating System (OS) commands allow you access to the 
facilities of Teletext from your own programs. Some of the commands should 
be used with care because they copy Teletext data into the computer's memory 
and if used incorrectly could corrupt your program. Certain of the Terminal's 
facilities, such as REVEAL, are not available as OS commands. These have to 
be implemented by your program if you wish to use them. 

Important: Before you use the Teletext OS commands you must issue a *TTXON 
command (see below) to tell the Teletext Adapter to start accepting Teletext data. 
When you have finished with Teletext, issue a *TTXOFF command to turn off the 
Adapter’s Teletext reception. This is important, as the computer’s memory may be 
corrupted by unexpected data arriving from the Adapter. 


4.2 The Commands 

All the commands can be typed in from the keyboard or included in a BASIC 
program. Each command is described separately under the following headings: 

Description What the command does in functional terms. 

Syntax The actual command words and the order in which commands 

and data are arranged. 

Example An example of a string of commands including the one 
described. 

Note Additional information. 

As with any other BBC Microcomputer OS command, Teletext allows you to 
type abbreviations for its commands, such as *TE. for *TELETEXT, or 
♦MAG. for ♦MAGAZINE. 


To avoid clashes of OS command names, the Teletext system allows an extra X 
to be placed before a command, e.g. *TTIME for *TIME, or ♦TPAGE for 
♦PAGE. 
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♦BBC 

Description 

This command is used to select channels 1,2,3 or 4 for Teletext reception. 
Syntax 

♦BBC <channel> 

where <channel> is 1,2,3 or 4. If no channel is specified, 1 is assumed. 

Example 

♦TTXON 

♦BBC1 

This will select channel 1. 

Notes 

It is up to you to ensure that channel 1 is tuned to BBC1 and channel 2 is tuned 
to BBC2 for this command to produce the expected results. 


*CH 

Description 

This command is identical to *BBC and is for use in countries other than the 
UK. It can also be used to select Channel 4. 

Syntax 
*CH <channel> 

where <channel> is 1,2,3 or 4. If no channel is specified, channel 1 is assumed. 

Example 

♦TTXON 

♦CH4 

This will select Channel 4 for Teletext reception. 
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♦DATA 

Description 

This command transfers the full data for the current page to a given memory 
location. For details of the data format, see Appendix C. 

Syntax 

♦DATA <address> 

where <address> is an area of memory reserved for the data. The memory of 
the current language processor is used, unless an address in the form FFFFxxxx 
is used. 

Example 

♦TTXON 

*S4C 

♦PAGE 400 

OSCLIfDATA ”+STR$~(Buffer)) 

Notes 

This command will wait forever if the current page cannot be found. ESCAPE 
will exit the command if ESCAPE is enabled. 

The area of memory reserved for the data must be 2K long, i.e. 2048 bytes. 


♦DATE 

Description 

This command causes the date, as transmitted in the television data packet to be 
displayed. 

Syntax 

♦DATE 

Example 

♦TTXON 

♦BBC1 

♦DATE 

Notes 

In order to give the Adapter time to grab the date, which is only transmitted once a 
second, you must leave a gap of at least 1.5 seconds between changing channel and 
asking for the date. 

If the Television Service Data Packet (TSDP) is not transmitted, an error 
message is displayed instead of the date. 
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♦DISPLAY 

Description 

This command is used to display any Teletext page which has previously been 
transferred into memory with a * TRANSFER command. It decodes the page 
from the internal form used by the Teletext system into the form required for 
screen display. The computer must be in Mode 7 or 135 (shadow) for this 
command to work properly. 

Syntax 

♦DISPLAY <address> 

where <address> is the hexadecimal address used in the *TRANSFER or 
♦DATA commands. If the address is eight digits long and the first four are 
‘FFFF’, the memory used will be that of the I/O processor, regardless of 
whether a co-processor is attached or not. 

Example 
MODE 7 
♦TTXON 
♦BBC2 
♦PAGE 200 
♦TRANSFER 7000 
♦DISPLAY 7000 

This will display BBC2 CEEFAX page 200 on the screen. 


♦HOFF 

Description 

This command switches off the top line display (Header) of the Teletext system. 

Syntax 

♦HOFF 
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♦HON 

Description 

This command controls the top line display (Header) of the Teletext system. It 
allows the top line to be displayed, with or without the clock. It also sets the 
display to any magazine (see *MAGAZINE). 

Syntax 

♦HON [0] Switch on the Header line with the clock display. 

♦HON 1 Switch on the Header line without the clock display. 

The square brackets mean that the zero is optional. 

Example 
♦TTXON 
♦BBC1 
♦HON 1 

PRINT TAB(32,0);CHR$(130);"HOLD"; 

This will switch on the Header for BBC1, and print the word ‘HOLD’ where the 
clock display normally goes. 

Notes 

This command only works if the screen display is currently Mode 7 (without 
shadow) and the screen has not been scrolled since the last CLS. Scrolling within a 
window does not matter. 


*ITV 

Description 

This command selects channel 3 or 4 for Teletext reception. If no number is given 
after the command, channel 3 is used. 

Syntax 

MTV 

MTV1 

MTV2 

Example 

*TTXON 

MTV 

*PAGE 100 

This will make page 100 of ORACLE the currently selected page. 

*LTUNE 

Description 

This command loads your ‘Channel data’ from Disc or Tape. 

Syntax 

*LTUNE filename 
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♦MAGAZINE 

Description 

This command controls which magazine's Headers are displayed. 

In Teletext, the pages are grouped together in ‘magazines’. These consist of up 
to 100 pages. The initial page digit signifies which magazine the page is in; 
103,156, and 175 are all in Magazine 1, and 704 is in Magazine 7, etc. 

There are two ways of transmitting Magazines in Teletext. In one the magazines 
are sent in numeric order, e.g. Magazine 1, Magazine 2, etc. This is called 
‘serial’ transmission. In this case, all the Headers for all the magazines are 
displayed and the ^MAGAZINE command has no effect. The other method is to 
send the magazines in ‘parallel’. An example page sequence might be 
100,200,101,201,102,202,etc. In this case the Headers appear to flicker. 

Syntax 

♦MAGAZINE <mag> 

where <mag> is the first digit of the page numbers to be displayed. 

Example 

♦TTXON 

♦ITV 

♦HON 

♦MAGAZINE 1 

This will display only those Headers whose page number begins with 1. 


♦NOTTX 

Description 

This command ‘removes’ the Teletext ROM from the Operating System's view. 
It produces the message ‘Press CTRL-BREAK...’. Once ‘removed’ in this way. 
Teletext no longer takes up any of the computer's memory and the Teletext 
commands become inoperative. The only way to ‘replace’ the ROM is to switch 
the computer off and on again. 

Syntax 

♦NOTTX 


Syntax 

♦NOTTX 
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Notes 

Switching the Teletext system on and off will alter PAGE in a Model B or B+ 
computer. You should therefore save any programs you are working on before 
issuing this command. This is NOT the case with *TTX. 


♦PAGE 

Description 

This command sets the specified Teletext page as the current page. 

Syntax 

♦PAGE <page number> [S<sub-page number>] 

The part within square brackets is optional. The page number must be 3 digits 
long, and the sub-page number four digits long. 

Example 

♦TTXON 

♦PAGE 119S0002 

This selects the second sub-page of page 119, channel 1. 

Note 

This command has nothing to do with the BASIC PAGE command. 


*S4C 

Description 

This command selects channel 4 for Teletext reception. It is up to you to ensure 
that channel 4 is tuned to S4C for this command to have the expected results. 

Syntax 

♦S4C 

Example 

♦TTXON 

♦S4C 

Dewiswch Sianel Pedwar Cymru. 

*STUNE 

Description 

This command saves the current channel data to Disc or Tape 
Syntax 

*STUNE filename 
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♦TELETEXT 

Description 

This command starts the Teletext Terminal. If a co-processor is in use, the 
Terminal is started as an OS command and is exited if BREAK is pressed. 
Otherwise, the Terminal is started as a normal language. 

Syntax 

♦TELETEXT 


♦TIME 

Description 

This command displays the local time, as transmitted by the Television Service 
Data Packet. 

Syntax 

♦TIME 

Example 

♦TTXON 

♦BBC1 

♦TIME 

Notes 

Time information is extracted from the television service data packet (TSDP). 
If the TSDP is not transmitted, an error message is displayed instead of the 
time. 


♦TRANSFER 

Description 

This command transfers the display data, for the current page to a given 
memory location. For details of the data format, see Appendix C. 

Syntax 

♦TRANSFER <address> 

where <address> is an area of memory reserved for the data. The memory of 
the current language processor will be used unless an address in the form 
FFFFxxxx is used. 
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Example 
♦TTXON 
♦BBC1 
♦PAGE 700 

OSCLIf TRANSFER "+STR$~(Buffer» 
or 

♦TRANSFER 7000 
Notes 

This command will wait indefinitely if the current page cannot be found. 
ESCAPE will exit the command if ESCAPE is enabled. 

The area of memory reserved for the data must be at least IK long, i.e. 1024 
bytes. 


*TTX 

Description 

This command controls the Teletext Adapter. If you wish to use Teletext, you must 
first issue a *TTXON command. When you have finished, you should issue a 
*TTXOFF command to switch off the Teletext Adapter. 

Syntax 

♦TTXON 

♦TTXOFF 

Example 

♦TTXON 

♦TIME 

Notes 

The *TTXPON and *TTXOFF commands are not necessary if you are using the 
Teletext Terminal, which automatically switches the Adapter on and off. 


♦TUNE 

Description 

This command invokes the tuning routine for the currently selected channel. 
For more details see Section 1.3. 

Syntax 

♦TUNE 


29 


The Advanced Teletext System User Guide 


PI70 CEEFAX 752 Sun 20 Apr 13:16/56 


□□0 entertainment 





Figure 7 A Page from CEEFAX 
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5 Teletext OSWORD Calls 


5.1 Introduction 

Teletext OSWORD calls allow you access to the facilities of Teletext from your 
own assembly language programs, and to access some of the lower level 
facilities available with the Teletext system. 

The basis of the Teletext system is the ‘page grabber’. This is a piece of machine code 
which constantly looks for a Teletext Page. Automatically storing it in the designated 
area of memory when it finds it. It also looks for, and stores, the TSDP- The Teletext 
OS command uses the page grabber to grab pages requested with *PAGE. From 
assembly language. 

All the facilities of the Teletext system are controlled by one OSWORD call &7A. 
The first byte of the parameter block for an OSWORD &7 A is a command code. The 
commands are described in Section 5.2. 


Teletext System Control 

OSWORD with A = &7A 
The call address is &FFF1 

On entry, X (lo-byte) and Y (hi-byte) point to the parameter block: 


Offset 



Important: Before you use the Teletext OSWORDS call, you must issue a *TTXON 
command, or an OS WORD & 7 A with command = 13, to tell the Teletext Adapter to 
start accepting Teletext data. When you have finished with the Teletext, issue a 
*TTXOFF command, or OSWORD &7A with command = 12, and command = 14, 
to switch off the Adapter’s Teletext reception. 


31 




The Advanced Teletext System User Guide 


5.2 The OSWORD Commands 

For each call a list of parameters is given, along with the offset within the 
parameter block at which they reside. 


0 Read Channel 

Read the channel which is currently being used for Teletext reception. 

Parameters: 

0 0 

1 Returned channel number (0 to 3 ; 0: BBC1) 


1 Set Channel 

Set the channel to be used for Teletext reception. 

Parameters: 

0 1 

1 The channel to be used (0 to 3). 


2 Read a Record Flag 

For the record in the page grabber there is an associated flag byte. This contains 
information such as whether the page has arrived yet, and if it is being updated at the 
moment. It also controls whether the page is on hold or not. The format of the flag is: 


BitO HOLD (0: No, 1: Yes) 

Bit 1 Page received (0: No, 1: Yes) 

Bit 2 Page being updated (0: No, 1: Yes) 

Other bits undefined. 

Parameters 

0 2 
1 0 

2 Flag for record requested 
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3 Set a Record Flag 

This command allows you to alter the flag for a particular record. This is done 
to HOLD or RELEASE a page and also to clear the ‘page received’bit so that a 
new copy of the page can be detected. 

Parameters: 

0 3 
1 0 

2 New value for flag 


4 Read a Page Grabber Record 


This command returns the page grabber’s record. 


Parameters: 


0 4 
1 0 

2 Magazine number of page being looked for 

3 Page number of page (in BCD i.e. & 23 means page 23) 

4 Sub-page number (hi-byte) & 3F means any sub-page 

5 Sub-page number (lo-byte) & 7F means any sub.page 

6 Address to put page (lo-byte) 

7 Address to put page (hi-byte) 


Note: The address is always in the I/O processor 


5 Set a Page Grabber Record 

This command allows you to specify which page should be grabbed. 

Sole: The page grabber always stores pages in the I/O processor memory. If you 
wish to store the pages in the co—processor, you must use the Teletext OS 
commands which will copy them across for you. 
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Parameters: 

0 

1 

2 

3 

4 

5 

6 
7 


5 

0 

Magazine number of page to be looked for 
Page number of page (in BCD, i.e. &23 means page 23) 
Sub-page number (hi-byte) &3F means any sub-page 
Sub-page number (lo-byte) &7F means any sub-page 
Address to put page data (lo-byte) 

Address to put page data (hi-byte) 


6 Read the No. of Rows to be Captured 

This command returns the number of rows that are being grabbed for the page 


Parameters: 

0 6 

1 Number of rows being grabbed 


7 Set the No. of Rows to be Captured 

This command allows you to specify the number of rows that are stored for the page 
If you only want to store the displayed part of a page, set the number of rows to 24. 
This will require 1024 bytes of memory per page. If you want to store non-display 
rows in addition to display rows, you should set the number of rows to 30. This will 
require 1260 bytes per page. 

Parameters: 

0 7 

1 Number of rows 


8 Read the Header Line Status 

This command returns the current status of the Header line. 
Parameters: 

0 8 

1 Header status 
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Status values are: 

600 Header off 

601 Header on with clock 

&FF Header on without clock. 

9 Set the Header Line Status 

This command sets the current status of the Header line (*HON). 

Parameters: 

0 9 

0 Header status 

See the previous call for the status values. 

10 Read the Magazine for Header Display 

This command returns the magazine whose Headers are currently displayed. 

Parameters: 

0 10 

1 Magazine 

Note: Magazine 8 is returned as zero. &FF means that all Headers are 
displayed. 


11 Set the Magazine for Header Display 

This command sets the magazine whose Headers are to be displayed 
(♦MAGAZINE). 

Parameters: 

0 11 

1 Magazine 

Note: Magazine 8 should be entered as zero. &FF means that all Headers are to 
be displayed. 
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12 Switch Off Teletext Interrupts 

This command disables the Teletext Adapter interrupts (*TTXOFF). 

Parameter: 

0 12 

13 Switch On Teletext Interrupts 

This command enables the Teletext Adapter interrupts *TTXON 

Parameter: 

0 13 


14 Clear Page Grabber Record 

This command clears the page grabber record. It should be issued before turning off 
Teletext interrupts if you are not going to re-enable them soon. 

Parameter: 

0 14 


15 Read Television Service Data Packet 

This command returns the TSDP, except for the ‘status message’ (which is not 
connected with Teletext). 

Parameters: 

0 15 
1 TSDP 
to 
13 

The Television Service Data Packet: 

Byte Meaning 

1 Magazine for initial page 

2 Page number for initial page (&FF: Not Specified) 

3 Page sub-code for initial page (hi-byte) 

4 Page sub-code for initial page (lo-byte) 

5 Network Identity Group (hi-byte) 

6 Network Identity Group (lo-byte) 
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7 Time offset from Universal Co-ordinated Time (UTC) 


8 

Modified Julian Date (10,000's) 

(BCD) 

9 

(1000's and 100's) 

(BCD) 

10 

(10's and l's) 

(BCD) 

11 

Universal Co-ord. Time (Hours) 

(BCD) 

12 

(Minutes) 

(BCD) 

13 

(Seconds) 

(BCD) 


The Network Identity Group is a 16 bit number, unique to each television 
channel. A list of the numbers used in the UK is given in Appendix C. You will 
see that each IB A company has its own identity number. 

The time offset allows the local time to be calculated from UTC. In the UK 
therefore, the time offset is normally &81, but in British Summer Time it 
becomes &85 to indicate that one hour should be added to UTC. Note that UTC 
is the international name for Greenwich Mean Time (GMT). 

The format of the offset is as follows: 

Bit Meaning 

0 Always 1 

1 Half-hour 

2 1 Hour 

3 2 Hours 

4 4 Hours 

5 8 Hours 

6 0: Add offset, 1: Subtract offset 

7 Always 1 


16 Clear Page Grabber Status 

This command halts the page grabber, even if it is half way through grabbing a 
page. 


Parameter: 

0 16 
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17 Read Teletext Adapter Status 

This command returns the status of the teletext Adatper. 

Parameters 

0 17 

1 Adapter Status 

Status: &00: On and connected 

&01: On, but no TV signal 
&02: Off, but connected 
&FF: No Adapter connected 


18 Set the Subtitle Enable Flag 

This command allows you to turn subtitle reception on and off. Subtitles are 
NOT stored, but displayed immediately upon reception. This allows them to 
remain synchronised with the TV program. 

Parameters: 

0 18 

1 Subtitle enable (&00: enable, &FF: disable) 

2 Subtitle magazine (normally 0) 

3 Subtitle page (normally &88) 


19 Set Interrupt Handling Flag 

This command allows you to control whether the Teletext ROM handles the 
interrupts from the Adapter, or whether they are passed on to other software. This 
can be used to allow very low level control of the Teletext Adapter. 

Parameters: 

0 19 

1 Interrupt enable (&00:enable, &FF: disable) 


20 Tuning Routine 

This command calls the tuning routine for the current channel. The call is 
terminated by pressing the SPACE-BAR. 

Parameter: 

0 20 
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21 Return Time from TSDP 

This command returns the local time in ASCII form. 

Parameters: 

0 21 

1 ‘HH:MM:SS’ time string 

10 Error flag (&00: time OK, &FF: time not found) 


22 Return Date from TSDP 

This command returns the local date in ASCII form. 

Parameters: 

0 22 

1 ‘DD/MM/YYYY’ date string 

12 Error flag (&00: date OK, &FF: date not found) 


23 Check CRC 

This command checks the CRC of the page pointed to. It allows you to check that the 
data collected by the Teletext Adapter has not been corrupted. This could be very 
important if the data being collected is of a finanical nature. 

Parameters: 

0 23 

1 Pointer to page data (lo-byte) 

2 Pointer to page data (hi-byte) 

3 Returned flag (0: No CRC, 1 :CRC OK, &FF: CRC Failed) 
Note: The page data must be in the I/O processor. 
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24 Download a File from Teletext 


This command downloads a file from the current channel. 


Parameters: 

0 24 

1 Pointer to filename (lo-byte) (terminated by &0D) 

2 Pointer to filename (hi-byte) 

3 Load address (lo-byte) (32 bits) 


6 Load address (hi-byte) 

7 Exec address (lo-byte) (32 bits) 


10 Exec address 

11 Magazine number 

12 Page number 

13 Load to memory/file 

14 Reset default tables 


(hi-byte) 

(0 to 7) 

(&00 to &FF) 

(&00: memory, &01: file) 
(&00: yes, &01: no) 


Notes: The filename must be in the I/O processor. The load address must 
agree with the load address in the file being downloaded. This is normally held 
in Block 1 of a file, or is available from the catalogue Hie (see Chapters 3 and 
6 ). 

When downloading to memory, the file is alsways stored at OSHWM onwards, 
regardless of the load address. When downloading to file, the load and exec 
addresses are set to those given in the telesoftware file. 

Normally, the default tables SHOULD be reset. 

The progress of downloading is shown by a graphical display representing the 
blocks received. 


25 De-Ham a Byte 

This command will translate an 8 bit hammed byte into a 4 bit decoded value. 

Parameters: 

0 25 

1 Byte to be decoded 

2 Decoded byte (&FF: unrecoverable error) 

Note: If bit 4 is set, but bit 7 is not, then an error occured in the transmission, 
but was recoverable, thanks to the hamming protection. The value returned 
should normally be ANDed with &0F before being used. 
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6.1 The Teletext Data Format 

Each row of Teletext data (normally equivalent to a single row of the screen 
display) takes up 42 bytes. The first byte contains the magazine number of the 
page, and the second byte is a ‘row address’. The row address is a number 
between 0 and 29. The first row is always row address 0. The following rows 
can be in ANY order. The maximum number of rows captured is controlled by 
OSWORD &7A:7. For *TRANSFER, 24 rows are captured, and for *DATA, 
48 rows. Unused rows have both the magazine and row address set to zero. 

Row 0 is the Header row and contains the full information on the Teletext page. 
The first byte after the two initial bytes is the page number. This is a 
hexadecimal number, so page 119 would have a page number &19. The next 
two bytes are the sub-page number, high byte first. If this is &0000 there is 
only one sub-page, otherwise it is the number of the rolling page received. The 
next two bytes contain the control bits for the page (see later). 

The next three bytes are all zero and have no meaning. Finally, there are 32 
bytes which are suitable for display and contain the displayed part of the 
Header, complete with the clock display. Each byte should be OR'ed with &80 
before being displayed. 

The following diagram shows the general format of the data, and the specific 
formats for rows 0 and 27 : 
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The control bits contain information such as whether the Page Header should 
be displayed, whether the page a newsflash, etc. The meaning of each bit is 
given below: 


| Byta *4 

Byta 5 \ 

Bit O 

Unusad 

Bit O 

EH 33 ZH 32 m 33 a 

1 

Unusad 

1 

Updata Indicator' 

2 

Unusad 

2 

Out of Saquanca 

3 


3 

Inhibit Display 

*4 

Naws Flash 


Sarial Magazina 

5 

Sub-Titla 

5 

Unusad 

6 

News Flash 

6 

Unusad 

7 

Sub-Titla 

7 

Unusad 


Rows 1 to 24 are suitable for display, except that each of the next 40 bytes 
should be OR'ed with &80 before being displayed. Not all the Rows 1 to 24 
need necessarily be present and those that are not should be assumed to contain 
40 spaces. 

Row 25 is not intended for display, but may contain 40 bytes of encoded tele¬ 
software. 

Row 27 contains the links to other pages and the Cyclic Redundancy Check 
(CRC). There can be up to four row 27s and they are distinguished by the first 
of the 40 data bytes. Once this byte has been de-hammed (see OSWORD 
&7A:25) it contains a value of 0 to 3. Only row 27/0 contains the CRC. Bytes 2 
to 37 of the data contain six links, each six bytes long. These six bytes must be 
de-hammed before use. The format of a link group is given below : 



larqgnamirirrTMnirTTl'I II 1 ■ 1 1 M 

O |1 

2 |3 |<4 |5 

Paga Numbar 

Paga Sub—Coda 



EDETQEj] 

Digit 3 

Digit 2 

\smsa 

llll 

Bifii 

KfifflB 

am 


1 

m 

□□□□ 

□□□ED 

□□□□ 

□□□□ 

□ □□□ 

□□□□ 

5 

2 

6 


O 

o 1 

Paga 25 s0016 of current magazine | 


The three bits, C3 (bit 3 of the fifth byte), C4, and C5 (bits 2 and 3, 
respectively, of the sixth byte) form a 3 bit number (C3 is the least significant 
bit of this number). This three bit number is EOR'ed with the magazine number 
of the current page to get the magazine number of the page pointed to by the 
link. Sub-code &3F7F indicates that the sub-code does not matter. Page number 
&FF means that the link is not being used. 
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The 38th byte of the data contains the Link Control. This byte must be 
de-hammed to give a four bits. The meaning of these bits is given below: 


Bit 3 Dat«rmin«s the meaning of Bits 0,1 and 2 


_ ° _ 

i i i 

Bit O 

Bit 1 

ill 

III 

111 

1111 

Him 

Bit O 

111 


O 

O 

Not Chained 

O 

fru MJH gminn 

1 

O 

Stant of Chain 

1 


O 

1 

End of Chain 

Bit 1 

ill 

SIM i 

1 

1 

Within Chain 

O 


Bit 2 

llillllillllllllillilllllllliilll 

1 

Yellow Key Enabled 

O 

Computer Readable 

Bit 2 

iiililllilliiilliiiiliittiiliMi 

1 

Ron Display 

O 

Blue Key Disabled 




1 

Blue Key Enabled 


The 39th and 40th bytes contain the 16 bit CRC. The algorithm used to calculate 
CRC’s is too complex to discuss here. Use OSWORD &7A:23 to check the CRC 
of any Teletext data. 

Rows 26, 28 and 29 are not transmitted in Level 1 Teletext. 


6.2 The Catalogue File Format 

The catalogue file contains a list of all the programs and files currently 
available on the telesoftware service of the selected channel. The format is as 
follows: 


The file begins with two strings, each intended for direct display and containing 
teletext colour codes. Each byte must be OR'ed with &80 before being 
displayed. The first byte of any string in the catalogue contains its length (not 
including the length byte itself). There then follow n entries, one for each file. 
Each entry consists of eight fields. 

Field one refers to the type of computer that the file is intended for and is a 
string. The computer types defined so far are : 

Any computer 

Commodore Amiga computers 
Amstrad computers 
Atari ST computers 

BBC Microcomputer System (B, B+, Master) 

Commodore 64 computers 
Commodore 128 computers 
Acorn Communicators 


ANY 

AMIGA 

AMSTRAD 

ATARIST 

BBC 

CBM64 

CBM 128 

COMM 
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CPM : Any CPM computer 

IBM : IBM Computers 

MSDOS : Any MSDOS computer 

SPECTRUM : Sinclair Spectrum computers 

*** : End of catalogue - no more data 

Field two is the filename, as a string, plus a single colour-code at the beginning 
of the filename. This colour-code is NOT part of the filename and is for display 
purposes only. 

Field three is a string, defining the type of file. This is completely free-format, 
but some examples of entries that might be included are given below: 


TEXT 
BASIC 
EXEC 
M 1C 

SCREEN 

FORTRAN 

PASCAL 


Text only files (ASCII) 

A BASIC program (tokenised if necessary) 

An EXEC file, possibly a BASIC program in text form 

Machine Code 

Screen picture 

Fortran source code 

Pascal source code 


Field four is a string, giving the size of the file. This is also completely 
free-format, but some examples of possible entries are given below : 


12 Pages 
&3453 Bytes 
8K 


Field five is the LOAD address of the file and is four bytes long (32 bits), with 
the most significant byte first (unlike 6502 format). 

Field six is the EXEC address of the file and is four bytes long, with the most 
significant byte first. 

Field seven is the magazine in which the file can be found. This is a single byte 
with values from 0 to 7. 

Field eight is the page number on which the file can be found. This is a single 
byte with values from 0 to 255. 
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6.3 The Teletext. Character Set 

Here is the Teletext Character set for the BBC Microcomputer. Note that it 
starts at &80 (128), NOT at &00. The characters in columns &C0, and &D0 are 
always shown, regardless of whether they are preceded by a graphic colour or 
not. 

HEX I eo I 90 I AO I BO I CO I DO I EO I F=0 I 



* These control characters are presumed before each screen row begins, 
t These control characters have no action on the BBC Microcomputer but 
may be contained in some Teletext pages. 
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6.4 The Teletext Control Codes 

The previous table shows the available characters, their codes and also the 
control codes. The control codes can be sent in place of any character code 
anywhere in a row. The control codes are normally displayed as spaces (but see 
the section below on the hold graphics control). The fact that they can be used 
within a row enables you to change some aspects of the display part way 
through a row (e.g. the display colour). 

Display Modes 

There are three modes of display in the Teletext system - one alphanumeric 
mode and two graphics modes. The two graphic modes are called contiguous 
and separated. The difference is best shown by illustration : 



Contiguous Separated 


Colour 

Seven different display colours are provided (red, green, yellow, blue, 
magenta, cyan, and white). Fourteen control codes are available to select 
alphanumerics or graphics and the required colour simultaneously. This 
provides a change of colour and mode in one step. 

The background colour can be any of the seven colours listed above, or black. 
Coloured background is selected by using the ‘new background’ control code. 
After this code appears, the new background colour will be the display colour 
in use when the ‘new background’ control was used. 

Flashing and Concealed Characters 

Two modes are provided in which the display characters appear as spaces some 
of the time. In flashing mode, a character appears alternately as a space and as 
the character at a rate determined by a clock in the computer. In conceal mode, 
the character appears as a space until revealed. The character is revealed by 
pressing ‘Reveal’ (16 on the BBC Microcomputer). 
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Double Height 

Characters may be displayed in double height, in which case they take two 
rows. Therefore the information sent in row n also applies to row n+1 in this 
mode. The decoder ignores row n+1 if it is sent. It is possible to mix single and 
double height characters, but single height characters can only appear on the 
top line of the two. 

Hold Graphics Control 

The hold graphics control code allows a limited number of abrupt display 
colour changes. A control code is normally displayed as a space which 
therefore causes a break in the display. In hold graphics mode, the character 
rectangle occupied by the control code is filled with a held graphics character. 
This can be used with any control code issued in the graphics mode. The held 
graphics character will be the most recent character with bit 6 equal to 1 in its 
code, provided that there has been no intervening change in either the 
alphanumeric/graphics modes or the normal/double height modes. In the 
absence of a suitable character, a space is displayed. 
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Figure 8 A Page from CEEFAX 
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A What is Teletext? 


Teletext is a service provided by the BBC and the IBA which makes available a 
wide variety of information through the medium of television. This 
information could be share prices on the stock market or the latest football 
results; the possibilities are almost endless. 

Teletext information is transmitted from BBC and IBA television transmitters 
and can be received on a commercial television receiver suitably equipped with 
a Teletext decoder. The transmitted signal, however, unlike a normal television 
signal, is in digital form which makes it additionally suitable for use with 
computers. 

The total amount of Teletext information is too large to be displayed on a 
television screen at any one instant and for this reason it is transmitted in ‘pages’ 
rather like the pages of a book. Only one page can be displayed on the screen at 
a time. 

A page of information may contain text, symbols, or a mixture of both; it 
depends on the type of information and how the broadcasters decide to present 
it. 

Because of the amount and variety of information available, transmitted 
Teletext pages are organised and numbered in such a manner as to enable you to 
locate and display specific items of information both quickly and easily. 

The service broadcast by the different channels usually consists of one or more 
‘magazines’. These magazines can incorporate up to 255 pages. Page references 
consist of three digits. The first digit always refers to the magazine number and 
as there is a maximum of eight magazines, can be any number from 1 to 8 (for 
OS WORD calls, 8 is represented as 0). 

The magazine number is followed by a two digit hexadecimal number. Page 
&00 normally contains an index to the magazine. Only those pages whose 
number is entirely numeric (i.e. no letters) are used for information that is 
meant to be displayed. The other page numbers are used for computer-readable 
information. 

Each page may contain more than one screen of information. Each of these 
screens is given a sub-page number, which is a four digit hexadecimal number. 
The sub-pages are sent in cycles, so when the last sub-page has been sent, the 
broadcast returns to the beginning of the cycle and re-transmits the first 
sub-page. The cycle continues until a new page is selected. 
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B Hints on Teletext Reception 


Generally, a good receiving system is as important for correctly-decoded 
Teletext as it is for receiving ordinary television broadcasts but, because of the 
digital nature of the Teletext signal, good reception is even more critical in 
certain situations. To display pages of text,Teletext relies on instructions 
received with the television signal. Depending on the quality of reception these 
can produce anything from a perfect or near perfect display to just a hopeless 
jumble of characters. Unfortunately, such jumbled characters can often arise 
even though the ordinary television picture appears satisfactory. The main 
cause of the problem is delayed signals. These can come from two sources: 
reflected signals picked up by the aerial from nearby hills or tall structures; 
reflections within the aerial and distribution system itself. 


Reflections External to the Aerial 

Reflections received by the aerial are normally visible on television pictures as 
ghosting (faint extra images). A suitable receiving aerial will usually reduce the 
ghosting to a level which is not disturbing on pictures and also does not affect 
Teletext signals. As the viewer is not normally able to try a selection of aerials 
it is best to use the services of an aerial contractor and to specifying that good 
Teletext reception is required, of course. 


Reflections in the Aerial System 

Reflections in the aerial system can be particularly troublesome since they can 
rarely be seen on normal television pictures except, perhaps, as an apparent 
sharpening of the picture or slight double-edging on vertical detail (not to be 
confiised with ‘ringing’, a regular pattern of diminishing after-images caused 
by deficiencies of the receiver). 

The problem rarely arises where an aerial feeds a single receiver but is 
commonly found with incorrectly installed multiple-outlet systems where a 
single aerial feed is split between several receivers or aerial sockets. Multiple 
outlet systems are commonplace in blocks of flats but simpler, smaller scale 
versions are increasingly used in households. The general rule is that in order 
to split the signal it is not permissible to simply join an extra cable into an 
existing one, since this creates an impedance mis-match and sets up the 
reflections in the cables. 
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Hints on Receiving Teletext 


1. Household Installations 

In a household installation the simplest device to split the signal is a 'passive 
splitter’ which, because of an inherent power loss, should be used only if the 
signal is strong enough in the first place. In order to prevent reflections 
appearing in the system, a television must be connected to each outlet at all 
times. If you have only one television and move it from room to room then a 
750 termination plug should be fitted to the spare outlets when not in use. 
Suitable attenuators and termination plugs are available from aerial suppliers 
and television retailers. 

If the received signal is too low to allow passive splitting, a ‘distribution 
amplifier’ should be fitted. These have between two and eight outlets depending 
on the make and model. The two outlet versions are frequently called ‘second 
set amplifiers’. Although it is good engineering practice to terminate unused 
amplifier outlets, Teletext reception should generally not suffer if they are left 
unterminated, unless there is a length of unterminated cable connected to the 
outlet. Amplifiers of this type are useful since they usually provide a slight 
increase in the signal level which will compensate for losses in long cable runs. 

2. Communal Systems 

In large distribution systems as in blocks of flats or hotels where there are many 
amplifiers and long cable runs, the problem of ‘pre-imaging’ may arise. In this 
case, the television set not only receives the signal through the cable but also 
receives a direct signal because the receiver and cable act as an aerial. The main 
symptom is noticeable ghosting on the picture caused by the delay between the 
cable-fed signal and the direct signal reaching the television receiver. To 
minimise the problem care should be taken with the lead connecting the wall 
outlet to the television: ensure that ‘double-screened’ cable is used, that it is as 
short as possible, and that the connections are electrically sound. If this does not 
cure the fault, then the system may need adjusting to provide a higher output 
signal or a translating device should be used to distribute the television channels 
on different frequencies. Once again, these items are available from aerial 
suppliers and television retailers. 

This information was provided by BBC Engineering Information Department. 

For more information on Teletext and Television reception contact: 

Engineering Information Department, 

BBC Broadcasting House, 

LONDON, 

W1A 1AA 

Telephone 01-927 5040 
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C United Kingdom Network Identities 


BBC1 

S5FFB 

BBCS 

B457F 

BBC A 

S9821 

BBC B 

60450 

BBC C 

BFC9C 

ITV Network 

Sc13"7B 

ITV Network 

Gc *495*4 

Channel *4 

B3F88 

S*4C 

B2DE3 

Anglia TV 

SDF39 

Border TV 

SEDEF 

Channel TV 

B3F27 

TSW 

Be A*40B 

Granada TV 

BB51B 


Grampian TV 

&CF5C 

Scottish TV 

R9F*4B 

ITV London 

&11D2 

ITV London 2 

G41BB 

TVS 

S0827 

TVS 2 

BBBOA 

HTV 

B5AF5 

HTV 2 

B4F1A 

Central TV 

BF<qE4 

Central TV 2 

BGA99 

Tyne Tees TV 

&1534 

Ulster TV 

&C1DC 

Yorkshire TV 

B5F34 

Not Identified 

ScOOOO 


A Table of the Network Identities for the United Kingdom 

The table above gives a 16 bit number for each TV station transmitting in the 
UK. To find the identity of the station being received you must compare the 
identity contained in the TSDP with the table entries. The following extract 
from a BASIC program includes a function to return the identity: 

10 DIM Buffer 20 

100 IF FNidentity = &5FF6 THEN PRINT "BBC1" 

1000 DEF FNidentity 
1005 Buffer?0=15 

1010 X% = Buffer: Y% = X% DIV 256 : A% = &7A : CALL &FFF1 
1020 = (Buffer?5)*256 + Buffer?6 
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D CP/M, PANOS, & DOS+ Telesoftware 


When using the Telesoftware Terminal, the files are saved to the current I/O 
processor filing system (i.e. DFS, ADFS, NFS, or ANFS) and not to the 
co-processor’s filing system. 

This does not matter if the co-processor is a 6502 or Turbo, as these use the 
same filing systems as the I/O processor. 

Similarly, if you are using PANOS f , you can access the files directly, because 
PANOS also uses the I/O processor filing system, although the filenames may 
appear slightly different, e.g. the file “F77.FORPROG” appears in PANOS as 
“FORPROGF77”. 

With CP/M* and DOS+* the situation is different. These co-processor filing 
systems do not use the same format as the I/O processor filing systems. To get 
round this a convert program is supplied with each one to allow files to be 
copied from the I/O processor filing system into CP/M or DOS+. 

Caution: Care should be taken when using Teletext from the Z80 
co-processor as CP/M uses the I/O processor’s memory to store the disc 
catalogue, and this will be corrupted if Teletext is used. 


t PANOS is a trademark of Acorn Computer PLC. 

* CP/M and DOS+ are trademarks of Digital Research. 
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E Copyright Position on Telesoftware 


The copyright situation on Telesoftware programs broadcast by the BBC is as 
follows: 

(i) Domestic users of a program broadcast on CEEFAX may: 

- Make two copies only for private purposes. 

- Adapt or modify it for private purposes but not for sale. 

(ii) Educational and training institutions and agencies may: 

- Record and use the program for their own educational training purposes 
but nor for sale. 

- Adapt, modify, and distribute a program for their own educational and 
training purposes but not for sale. 

(iii) No part of a program may otherwise be reproduced, stored in a retrieval 
system or transmitted in any form or by any means, without the prior 
permission of the BBC, except in accordance with the 1956 copyright act. 

Different concessions apply, and are set out in detail in ‘Recording BBC 
Educational Programmes’, with respect to those BBC programmes listed in 
‘The Annual Programme for Schools and Colleges’ and/or ‘The Annual 
Programme for Continuing Education’. 

All other BBC programmes may not be recorded without the prior consent of 
the BBC and the holders of the copyright and performing rights in the 
component parts of the programmes concerned. 
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F Fitting the Teletext ROM 


Before installing any ROMs you should switch off your computer and unplug it 
from the mains. 


Model B 

1 Remove the top cover. To do this: 

a Remove the two fixing screws from the underside, they are large 
cross-head screws marked ‘FIX’, 
b Remove the two fixing screws at the back of the machine, 
c Lift the top cover upwards. 

2 Loosen the keyboard. To do this: 

a Undo and remove the two fixing nuts and bolts at the sides of the 
keyboard. (Don’t forget to remove the washers.) 
b Move the keyboard carefully to reveal the ROM sockets at the front right 
of the circuit board. (The keyboard is connected to the circuit board by a 
red and black twisted wire and a flat grey cable. If you wish you can 
unplug these from the circuit board so as to remove the keyboard 
completely. Before removing them notice carefully how they plug into the 
circuit board so that you can replace them correctly.) 

3 Plug the ROM into one of the sockets marked by the arrows in the diagram 
below. The ROM should be inserted with the dimple at the top facing the rear 
of the machine. The BASIC and filing system chips may be in different 
sockets on your computer. This does not matter but normally the ROM you 
are inserting should go to the left of BASIC. If there is no empty socket to the 
left of BASIC, you may have to move the ROMs. If you wish Teletext to start 
when you switch on the computer, you should insert it to the right of BASIC, 
and any other language ROMs you have. 
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The ROM Sockets on the Model B 
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CAUTION: Handle the ROM with care and do not touch the pins. 

Make sure that the ROM is correctly aligned with the socket. 

Each pin should fit into a hole, and there should be none hanging over the edge 
of the socket. Make sure that all the pins are correctly seated before pushing the 
ROM home. 

DO NOT USE EXCESSIVE FORCE. If a pin is not correctly seated it is easy to 
bend it up under the ROM if you push too hard. 

4 Replace the keyboard. 

a If you have unplugged the wire and cable, carefully plug them back into 
the the circuit board. 

b Replace the nuts and bolts securing the keyboard. Do not forget the 
washers, which go between the nuts and the keyboard base. 

5 Replace the top cover. 

a Place the cover in position. 

b Replace the two fixing screws in the base and the two at the back and 
tighten. 

6 Replace die mains power plug and switch on the computer. 


Model B+ 

1 Remove the top cover. To do this: 

a Remove the two fixing screws from the underside, they are large 
cross-head screws marked ‘FIX’, 
b Remove the two fixing screws at the back of the machine, 
c Lift the top cover upwards. 

2 The ROM sockets on the Model B+ are located in the top left hand area of the 
circuit board (near the large copper-coloured power supply, towards the 
back of the computer). There are six sockets arranged in two rows of three. 
Nearer the keyboard are two very similar sockets for the speech system. 
Under no circumstances should a ROM be placed in these speech 
sockets. Some of the six ROM sockets will already contain ROM's and the 
top-right ROM should not be moved, as this contains the operating system. 

The diagram below shows the ROM sockets on the Model B+, along with the 
two speech sockets. 


Fitting the Teletext ROM 





The ROM Socket on the Model B+ 

CAUTION: Handle the ROM with care and do not touch the pins. 

Make sure that the ROM is correctly aligned with the socket. 

Each pin should fit into a hole, and there should be none hanging over the edge 
of the socket. Make sure that all the pins are correctly seated before pushing the 
ROM home. 

DO NOT USE EXCESSIVE FORCE. If a pin is not correctly seated it is easy to 
bend it up under the ROM if you push too hard. 

3 Replace the top cover. 

a Place the cover in position. 

b Replace the two fixing screws in the base and the two at the back and 
tighten. 

4 Replace the mains power plug and switch on the computer. 
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Master Series 

The simplest way to use the ROM with a Master, is to use the EPROM cartridge 
(ADF13), available from your Acorn Dealer. Otherwise you will have to insert 
the ROM into one of the three internal ROM sockets. 

1 Remove the top cover. To do this: 

a Remove the four fixing screws from the underside, they are large 
cross-head screws marked ‘FIX’, 
b Lift the top cover upwards. 

2 The ROM sockets on the Master are located on the far right hand side of the 
circuit board, just above the cartridge slots. There are four, arranged one 
above the other. The top socket contains the 128K Operating System ROM. 
Of the remaining three, the middle one is the easiest to use. Insert the ROM 
as before, making sure the dimple at the top of the ROM goes on the left. 

If the middle socket is occupied you will have to change two links 
on the circuit board. If you want to use the top socket, i.e. the one below the 
128K ROM, you should change link 19 so that the two right-most pins are 
connected, and link 12 so that the two right-most pins are connected. This 
will disable banks 6 and 7 of the sideways RAM, and replace them by the 
ROM. To use the bottom-most ROM socket you should change link 18 so that 
the two right-most pins are connected, and link 12 so that the two right-most 
pins are connected. This will disable banks 4 and 5 of the sideways ROM, and 
incidently, stop the ‘Convert’ program from working. 
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The ROM Sockets on the Master Series 

3 Replace the top cover. 

a Place the cover in position. 

b Replace the four fixing screws in the base and tighten. 

4 Replace the mains power plug and switch on the computer. 
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G Summary of OS Commands 


♦BBC ^Channel 
*CH <Channel > 

♦DATA <Address > 
♦DATE 

♦DISPLAY < Address > 

♦HOFF 

♦HON [1] 

♦ITV < Channel > 
♦LTUNE < Filename > 
♦MAGAZINE <Mag> 

♦NOTTX 

♦PAGE < Page Number> 
♦S4C 


*STUNE< Filename > 

♦TELETEXT 

♦TIME 

♦TRANSFER < Address > 
♦TTX ON/OFF 
♦TUNE 


Select channels 1,2,3, or 4. 

Select channels 1,2,3, or 4. 

Transfer 2K of Teletext data into memory. 
Display the local date (from TSDP). 
Display Teletext data held in memory. 

Turn off the changing top line. 

Turn on the changing top line. 

Select channels 3 or 4. 

Loads Channel data. 

Select magazine whose top lines will be 
displayed. 

‘Unplug’ the Teletext ROM. 

Select the page to be captured. 

Dewiswch Sianel Pedwar Cymru. 

(Select Channel 4 Wales). 

Saves Channel data. 

Enter the Teletext terminal. 

Display the local time (from TSDP). 
Transfer IK of Teletext data into memory. 
Turn the Teletext system on or off. 

Tune the current TV Channel. 
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H Summary of Terminal Keys 



Release All Kept Pages 
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